home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d8 / pcz31190.arc / PCZ.DOC < prev    next >
Text File  |  1990-09-29  |  15KB  |  388 lines
  1.  PCZ 3.09.90  August 16, 1990
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.                    PCZ - A Public Domain implementation
  13.                 Zmodem, Ymodem, Xmodem, Xmodem-1K, Sealink
  14.                           for the IBM PC family
  15.  
  16.               PcConnect Zmodem by Drue Kennon and Gary Smith
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.          PCZ is a public domain Zmodem implementation that will allow
  33.          users of communication software that does not implement internal
  34.          Zmodem to access it through an external program.  It is a
  35.          fully-featured version of Zmodem, but does not have the large
  36.          volume of options provides by Omen Tech's DSZ.  However,
  37.          I do believe that it will be suitable for the average BBS'r.
  38.  
  39.          PCZ provides support for the basic Xmodem variants:
  40.          Xmodem, Xmodem-1K, Ymodem Batch & SEAlink.
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49. The following is a description of how to start PCZ for file transfers.
  50.  
  51. LEGEND
  52.       Data enclosed in  "[" "]"  is optional.
  53.       Data enclosed in  "<" ">"  is required.
  54.  
  55.  
  56. Command line:
  57. Send
  58.         PCZ [PORT] <1-8> [SPEED] <300-19200> [f] <sz> [r] [@]<filenames.ext>
  59.  
  60. Recv
  61.         PCZ [PORT] <1-8> [SPEED] <300-19200> [f] <rz> [r] <filename.ext>
  62.  
  63.  
  64. Ref:
  65.         port       -    the word "PORT"
  66.         1-8        -    the number 1 - 8
  67.         speed      -    the word "SPEED"
  68.         300-19200  -    the number 300, 1200, 2400 etc...
  69.         f          -    enable FOSSIL driver routines
  70.         *z         -    transfer type command e.g. sz, rz, sx, rx etc...
  71.         r          -    resume/recover aborted transfer (zmodem only)
  72.         @          -    cmdfile transfer alert flag
  73.         filename.ext    file name w/extension
  74.  
  75.  
  76. Due to the nature of the beast, no support is provided for a default port &
  77. no default port speed is assumed.
  78.  
  79. I personally never enter "port" or "speed", but always enter
  80. their values.  i.e. pcz 1 9600 f sz xxxxxxx.xxx  The batch files
  81. included reflect this method.
  82.  
  83.  
  84.  
  85. "ZMODEM BATCH RECEIVE"
  86. To receive file(s) using Zmodem simply enter :
  87.  
  88.        |-- PCZ 1 9600 rz       - Using com port one, assume sender names.
  89.  batch |   PCZ 2 300  rz       - Using com port two.   """
  90.  modes |   PCZ 3 2400 rz       - Using com port three at 2400 baud.  """
  91.        |-- PCZ 4 1200 rz       - Using com port four at 1200 baud.   """
  92.  
  93.  one file mode:
  94.  PCZ 1 9600 rz INFILE.ARC - Receives one file and names it INFILE.ARC
  95.  PCZ 1 9600 rz r INFILE.ARC - Recovery xfer effort on file INFILE.ARC
  96.  
  97.  
  98.  
  99. "ZMODEM SEND"
  100. To send one file using Zmodem simply enter :
  101.  
  102.      PCZ 1 300 sz OUTFILE.ARC       - Using com port one at 300 baud.
  103.      PCZ 2 2400 sz OUTFILE.ARC      - Using com port two at 2400 baud
  104.      PCZ 3 9600 sz OUTFILE.ARC      - Using com port three at 9600 baud.
  105.      PCZ 4 1200 sz OUTFILE.ARC      - Using com port four at 1200 baud.
  106.      PCZ 1 9600 sz r OUTFILE.ARC    - Send file and resume aborted transfer.
  107.  
  108.  
  109. "ZMODEM BATCH SENDING"
  110. To send a batch of files via Zmodem :
  111.  
  112.         Create a TEXT command file with one complete file spec. per
  113.         line, which includes drive and directory information for
  114.         each file that is not in PCZ's resident directory.
  115.  
  116.         e.g. C:\MYDIR\THISFILE.ZIP
  117.  
  118.         A maximum of 25 files is allowed.
  119.         Have no blank lines in the file and place the "@" symbol
  120.         as the first character of the filename.  Pass it
  121.         to PCZ on the command line as follows:
  122.  
  123.         PCZ 1 2400 sz @OUTFILE.TXT  - Uses port 1 at 2400 baud.
  124.  
  125.         What you name the command file is your business.  It simply
  126.         must be a standard ASCII file with no software or printer
  127.         control codes present.
  128.  
  129.         An alternative to creating the command file for sending
  130.         2 or 3 files may be used.  Simply type the file names on the
  131.         dos command line seperating each one with a space.
  132.  
  133.         Remember the receiver must be set to accept batch uploads
  134.         or you might be spinning your wheels.  Some BBS packages
  135.         are just now comming online with batch upload features using
  136.         PCZ or DSZ.  They normally indicate (BATCH) if acceptable.
  137.  
  138.  
  139. "XMODEM VARIANTS"
  140. To receive files using any of the Xmodem variants, the format is :
  141.  
  142.      PCZ <port> <speed> rs filename   -  SEAlink recieve
  143.      PCZ <port> <speed> rs            -  SEAlink Batch recieve
  144.  
  145.      PCZ <port> <speed> rx filename   -  Xmodem receive
  146.      PCZ <port> <speed> r1 filename   -  Xmodem-1K receive
  147.  
  148.      PCZ <port> <speed> ry filename   -  Ymodem receive
  149.      PCZ <port> <speed> ry            -  Ymodem Batch receive
  150.  
  151.  
  152. To send files using any of the Xmodem variants, the format is :
  153.  
  154.      PCZ <port> <speed> sx filename   -  Xmodem
  155.      PCZ <port> <speed> s1 filename   -  Xmodem-1K
  156.      PCZ <port> <speed> sy filename   -  Ymodem *
  157.      PCZ <port> <speed> ss filename   -  SEAlink *
  158.  
  159.      *Refer to Zmodem Batch sending for batch transfers via
  160.       Ymodem and SEAlink
  161.  
  162.  
  163.  
  164. "ENVIRONMENT VARIABLES"
  165.  
  166. PCZ supports several environment variables which can make setting up a
  167. comm pkg or BBS more "user friendly".  These variables are as follows and
  168. should be placed in the autoexec.bat file as I have them shown here:
  169.  
  170. set DIRRX=drive:\yourdir\
  171.  
  172. set PCZLOG=drive:\yourdir\
  173.  
  174. drive = a letter "A" - "Z" etc...  yourdir is the directory you want PCZ to
  175. place all your downloaded files into.  In the case of the log file, it
  176. specifies the directory you want your pcz.log file kept in.  If PCZLOG is
  177. not found in the environment then no log file is generated. As an option to
  178. the log file name "PCZ.LOG" you may specify a filename in the filespec. i.e.
  179.  
  180. set PCZLOG=C:\COMM\MYLOG.FIL
  181.  
  182. This provides greater flexibility with some bbs pkgs such as RBBS which likes
  183. it's own names in a multitasking environment etc...  If the filename.ext
  184. exist, it overrides "PCZ.LOG" in all cases.
  185.  
  186.  
  187. set PCZPORT=(1-8)
  188.  
  189. PCZ will use the port number (1-8) you specify as the default port.
  190.  
  191. set PCZSPEED=(300-19200)
  192.  
  193. PCZ will use the speed (300-19200) you specify as the default speed.
  194.  
  195. If you specify a PORT or SPEED on the command line, it will override
  196. the default set by the environment variables.
  197.  
  198. IMPORTANT NOTE:
  199. NO SPACES are allowed in the setting of an environment variable!
  200. e.g.
  201. set PCZLOG = C:\COMM\  will not work.
  202. That's not my fault.  It is just DOS....
  203.  
  204. Note: the bytes and cps rate reflect the actual number of bytes sent to,
  205. or received from the IOBuffer.  It does not necessarily reflect any specific
  206. "BLOCKSIZE".  This will let you see actually how PCZ is progressing in the
  207. transmission of data.  In the best case "Full Streaming Zmodem", you will
  208. see the time for actual file data; worse case time will reflect the
  209. transmission of data headers and block acks.  It is different, but I hope
  210. everyone can appreciate a more accurate account of what is happening inside
  211. the powerful zmodem protocol.
  212.  
  213. ** : The "Transfer Time" reflects port speed, NOT modem speed!
  214.      If speed conversion is being used, FORGET the transfer time.
  215.  
  216.  
  217.  
  218. "FOSSIL SUPPORT"
  219. FOSSIL is an acronym for "Fido/Opus/SEAdog Standard Interface Layer".
  220. This version of PCZ implements the use of FOSSIL communications support.
  221. To date only one,  "X00.SYS"  has been tested to work with PCZ.  X00.SYS
  222. is a product of Raymond Gwinn.  It has proven itself in many environments
  223. and I recommend it to you without reservation.  X00.SYS was chosen because
  224. it provides support for the 16550 UART chip which my internal routines
  225. don't, and for the enhanced ability to work in a multitasking environment
  226. such as DeskView.  If DeskView is active PCZ gives idle time back to the
  227. processor for enhanced operation.  For a brief description of setting up
  228. X00.SYS on your system read the enclosed file PCZFOSSL.DOC
  229.  
  230. Making use of the driver is as simple as adding "f" to the command line.
  231. It should be placed after the baudrate in all xfer types.
  232. e.g.
  233.      PCZ 1 9600 f sz OUTFILE.ZIP
  234.  
  235. When PCZ starts, it will check for the presence of the driver in memory.
  236. If it is resident all will proceed as planned.  If however, the driver
  237. is not in memory,  PCZ will gracefully shut down with a message stating
  238. this fact.  I gave careful thought to jumping to the internal routines,
  239. but decided against it for a couple of reasons.  In some cases the ports
  240. may be scrambled which will surely cause a system lockup on PCZ's part.
  241. A problem may exist with the driver your using, giving false info which
  242. PCZ's routines would not like very much.  A "dumb" terminal might have
  243. charge of things and not want another routine hanging around, etc...
  244.  
  245.  
  246. "PHONE SUPPORT"
  247. Phone support can be provided when you require it, if you call while
  248. I am home.  I umpire for our local women's softball league on Mon. &
  249. Tues. nights.  I play golf on Wed. & Thurs. evenings.  Fri. night I
  250. do what Maureen tells me to do!  Sat. is up for grabs and Sun. morn &
  251. evenings I am in church.  Please try me sometime other than those
  252. mentioned......   Seriously though, any night (late) will be fine.  Just
  253. try and make it before 10p.m. cst if possible.
  254.  
  255.  
  256.  
  257.  
  258.  
  259. Note from the author:
  260.         Over the last year PCZ has received some very good reviews. More
  261.         users rely on the program for their transfers now than I thought
  262.         would ever be interested.  For this I am especially grateful and
  263.         would thank each one if possible.  Gary & I will continue to grow
  264.         with the needs of the BBS community.  We ask for your continued
  265.         input and support, with our assurance that your ideas and "jeers"
  266.         are taken with sincerity.
  267.                                               Thanks
  268.                                               Drue
  269.    
  270.  
  271.  
  272.  
  273.  
  274.  
  275.                         History
  276.                         -------
  277.  
  278.         V1.01.88 - Intial release, no known bugs.  Please report
  279.                    any problems to Drue Kennon.
  280.  
  281.         V2.01.89 - Extended version that contains Xmodem, Xmodem-1K,
  282.                    Sealink, and Ymodem Batch in addition to Zmodem.
  283.                    Also provides full file sharing for use in
  284.                    networking enviroments.
  285.  
  286.         V2.11.89
  287.                   Fixed several reported bugs.  Enabled hardware flow
  288.                   control for use with MNP type modems. Enhanced port
  289.                   speeds up to 19.2k, and tightened some code for
  290.                   more efficient operation. Properly set errorlevel 1
  291.                   in event of transfer failure.
  292.  
  293.         V3.03.90
  294.                   Fixed a problem with SEAlink xfers not seeing the
  295.                   last EOT.  Batch sending for SEAlink per request.
  296.                   enhanced some screen data writes
  297.  
  298.         V3.06.90
  299.                   Fixed a problem with SEAlink xfers created by making
  300.                   the last fix.   Zmodem command file name can't be
  301.                   fouled due to misunderstanding the docs.
  302.  
  303.                   NOTE:  Unless forced into it by the users, I do
  304.                          not plan to support 7 bit data transfers.
  305.                          Nor can I figure why any BBS would?  Did
  306.                          I misssssy something along the way?
  307.  
  308.         V3.08.90
  309.                   Got with the program and added support for FOSSIL
  310.                   driver.  e.g.  Gwinn's Communications Controller,
  311.                   X00.SYS   (add "f" to cmd line params for fossil).
  312.                   Removed internal support for default port and speed
  313.                   which caused problems for multitaskers. Defaults
  314.                   are now specified through environment variables.
  315.                   Added environment variable for default receive dir.
  316.                   Reinstated environment variable for pcz log file.
  317.  
  318.         V3.09.90
  319.                   By popular demand, namely "Gary", I added yet another
  320.                   multitasker enhancement.  Since the cpu is much faster
  321.                   than the port, idle time occurs during output.  This
  322.                   time is now "given back" to the cpu, allowing the
  323.                   "other side" to operate more efficiently.
  324.  
  325.         V3.10.90
  326.                   Some users mentioned that PCZ would wait forever in a
  327.                   transfer if the carrier was lost.  I couldn't dupe the
  328.                   problem, but added several more checks nonetheless.  The
  329.                   logfile has changed so that you may specify a full file
  330.                   spec. including filename for you logfile in the env. var.
  331.                   The first char of each line in the file represents pass
  332.                   or fail. "0" = failed xfer  "1" = good xfer.  Keep those
  333.                   cards and letters coming!
  334.  
  335.  
  336.  
  337.         Contact may be made by any one of the following methods.
  338.  
  339.  
  340.                 Drue Kennon                    Gary J. Smith
  341.                 Rural Route #2 Box 54          6122 Cedar Wood Drive
  342.                 Center, TX. 75935              Columbia, MD 21044
  343.                 Voice 409-598-3809
  344.  
  345.  
  346.                              The Programmer's Corner
  347.                                      Home of
  348.                         "PcConnect" BBS Software & "PCZ"
  349.  
  350.          Data/BBS:   301-596-1180            Data/BBS:   301-995-3744
  351.  
  352.                              6 roll over lines in place
  353.                              with over 3/4 gigabyte of
  354.                              storage space
  355.  
  356.  
  357.  
  358.  
  359.  
  360.         For use by corporations, government, institutions, or for
  361.         profit, contact Omen Technology Incorporated for licensing
  362.         information using their excellent commercialized Zmodem
  363.         implementation. i.e. "DSZ"
  364.  
  365.  
  366.                    Chuck Forsberg
  367.                    Omen Technology Inc
  368.                    The High Reliability Software
  369.                    17505-V Northwest Sauvie Island Road
  370.                    Portland Oregon 97231
  371.                    Modem: 503-621-3746 Speed 1200,2400,19200(Telebit PEP)
  372.                    Compuserve:70007,2304  GEnie:CAF
  373.                    UUCP: ...!tektronix!reed!omen!caf
  374.  
  375.  
  376.     Omen Technolgy makes Professional-YAM, a comphrensive comms program with
  377.     unmatched power.  Flavors are available for PC-DOS, Unix, Xenix, and OS/2
  378.     Protected mode.
  379.  
  380.     ZCOMM is a full featured shareware communications package.
  381.  
  382.     DSZ, ZCOMM, Professional-YAM
  383.     are Copyrights of Omen Technology Inc, all rights reserved.
  384.  
  385.     X00.SYS Copyright (c) by Raymond L. Gwinn, All Rights Reserved
  386.  
  387.     PCZ.EXE Copyright (c) by Drue Kennon, All Rights Reserved
  388.